Encourage the use of markup files as documentation in enterprise [closed]
Posted
by
linquize
on Programmers
See other posts from Programmers
or by linquize
Published on 2012-11-22T08:59:01Z
Indexed on
2012/11/22
11:13 UTC
Read the original article
Hit count: 304
To make it eaiser to do version control and diff files of documentation, use markup files,
such as HTML: html/xhtml, XML: docbook, Wiki: markdown to replace doc/docx.
docx is too complex and lengthy.
For html, no extra document generation required. Programmers can write html directly and end users / managers can use any web browsers to view the document.
For custom XML or Wiki formats, viewers are required to view the document or converters are used to export to pdf/doc.
Is such move becoming popular in enterprise context? Why or why not?
© Programmers or respective owner